QuickTime 3 Reference

Save and Restore Component Routines

If you are writing movie data exchange components, you need to implement two additional component routines in order to allow your components to have their settings saved and restored. A component's settings are stored in a QuickTime QTAtomContainer. The data stored in the QTAtomContainer is private to the particular component but should be stored so that it is possible to read the data on all platforms supported by QuickTime, thus allowing the same settings to be used anywhere. (The next section, "Settings Container Format and Guidelines," provides further details.) For each type of movie data exchange component, there is one routine to return a QTAtomContainer holding the settings and another routine to configure the component from previously-saved settings.

Import component developers need to implement the MovieImportGetSettingsAsAtomContainer and MovieImportSetSettingsFromAtomContainer routines. For MovieImportGetSettingsAsAtomContainer , the component should allocate a new QTAtomContainer, stuff current settings into it, and return it to the caller. For MovieImportSetSettingsFromAtomContainer , the component should accept a QTAtomContainer, extract the settings in which it is interested, and change its internal state.

Export component developers need to implement the MovieExportGetSettingsAsAtomContainer and MovieExportSetSettingsFromAtomContainer routines. Like import components, the component's MovieExportGetSettingsAsAtomContainer routine will allocate and return a QTAtomContainer holding the component's settings. For MovieExportSetSettingsFromAtomContainer , the component will accept a QTAtomContainer, extract the settings, and update its internal state.